home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 2 / Amiga Tools 2.iso / tex / macros / source / contrib / supported / xypic / install.oztex < prev    next >
Text File  |  1995-03-15  |  30KB  |  702 lines

  1. -*-text-*- $Id: INSTALL.OzTeX,v 2.12 1994/10/25 03:01:14 ross Exp $
  2.  
  3.        ================================================
  4.        INSTALLING THE XY-pic DIAGRAM TYPESETTING MACROS
  5.             ON OzTeX INSTALLATIONS
  6.        ================================================
  7.  
  8. This file explains step by step how to install XY-pic for use with
  9. OzTeX by Andrew Trevorrow.  Please refer to the generic `INSTALL' file
  10. for details on the individual files.
  11.  
  12. Contents:
  13.  
  14.   -1- Adding XY-pic to the TeX search paths
  15.   -2- Memory requirements
  16.   -3- OzTeX and the PostScript backend
  17.   -4- Bugs & comments
  18.   -5- Setup files
  19.  
  20. ----------------------------------------------------------------------
  21.   -1- ADDING XY-pic TO THE TeX SEARCH PATHS
  22. ----------------------------------------------------------------------
  23.  
  24. Follow these steps to make XY-pic `visible' to OzTeX:
  25.  
  26. INSTALLING MACROS:
  27.  
  28. 1. Create a subfolder `:TeX-inputs:XY-pic:'.
  29.  
  30.    This folder will contain the XY-pic input files.  It is NOT
  31.    sufficient to create an alias to an existing folder which already
  32.    contains these files.
  33.  
  34. 2. Append this directory name to the line
  35.  
  36.        TeX input folder(s)    = ....
  37.  
  38.    in the `:Configs:Default' file.
  39.    
  40.  
  41. 3. Within the folder `:Configs:' create the files
  42.  
  43.     :Configs:Default+XYpic 
  44.     :Configs:Big TeX+XYpic
  45.     :Configs:Big XY-TeX
  46.  
  47.    which are included below (in section -5-).
  48.    Alternatively, these files are included separately with the 
  49.    `XY-pic Macintosh Distribution' in the `for OzTeX only:tfm' folder.
  50.    
  51.  
  52. 4. Within the folder `:TeX-inputs:XY-pic:' place copies of all of
  53.    the files from `texinputs'.
  54.    ... or from the `for TeX Inputs' folder, included with the 
  55.    `XY-pic Macintosh Distribution'.
  56.    
  57.  
  58. INSTALLING FONTS:
  59.  
  60. 5. Create a subfolder `:TeX-fonts:XY-pic:'
  61.  
  62.    This folder will contain the XY-pic font metrics files.  It is NOT
  63.    sufficient to create an alias to an existing folder which already
  64.    contains these files.
  65.     
  66. 6. Within the folder `:TeX-fonts:XY-pic:' place copies of all of
  67.    the files from `texfonts'.
  68.    ... or from the `for OzTeX only:tfm' folder, included with the 
  69.    `XY-pic Macintosh Distribution'.
  70.  
  71. 7. For each of the subdirectories in `pkfonts': `cx300', `cx329', and
  72.    `cx360' copy all files to the corresponding folder
  73.  
  74.     :PK-files:300:
  75.     :PK-files:329:
  76.     :PK-files:360:
  77.  
  78.    ... or find these fonts in the `for OzTeX only:pkfonts' folder, 
  79.    included with the `XY-pic Macintosh Distribution'.
  80.  
  81. INSTALLING THE PostScript BACKEND:
  82.  
  83. 8. Within the folder `:PS-files:' place a copy of the file
  84.    `ps:xy212dict.ps'. This is placed here for safe-keeping only.
  85.  
  86. 9. Within each directory in which you work, you will need a copy
  87.    of this file, renamed to be called `global.ps'.
  88.  
  89.    Read section -3- below, to understand what is required here.
  90.  
  91. ----------------------------------------------------------------------
  92.   -2- MEMORY REQUIREMENTS
  93. ----------------------------------------------------------------------
  94.  
  95. XY-pic is a big package, requiring quite a lot of memory if a large
  96. number of diagrams, or a small number of large diagrams, are to be
  97. typeset.
  98.  
  99. Using the `Default' configuration and `Plain' format, then XY-pic will
  100. load, but expect trouble unless you need it only for small diagrams.
  101. With `LaTeX2e' then XY-pic will not even load all of its standard
  102. options.
  103.  
  104. Thus using `Big-TeX' should be regarded as ABSOLUTELY ESSENTIAL, to do
  105. any serious typesetting --- though read the rest of this section
  106. before doing this.  Of course this will mean rebuilding the `Plain'
  107. and `LaTeX2e' formats using `INITEX' and increasing the Finder
  108. memory-partition from the OzTeX application's `Get Info' dialog box.
  109.  
  110. Since `Big-TeX' inherits and overrides settings from `Default' it is
  111. not necessary to make any alterations for XY-pic --- at least not for
  112. use with the `Plain' format.
  113.  
  114. However even `Big-TeX' is too small, in some of its parameters, for
  115. `LaTeX2e' and XY-pic to coexist peacefully. If you try this then the
  116. first type of memory to run out is the `pool size':
  117.  
  118.     ! TeX capacity exceeded, sorry [pool_size=60000].
  119.  
  120. To fix this requires increasing the "pool_size" parameter, to say
  121. 160,000.  This should be sufficient unless the document contains large
  122. diagrams or diagrams such that many curves appear on the same or
  123. adjacent pages, and the XY-ps PostScript option is NOT in
  124. effect. Expect to encounter...
  125.  
  126.     ! TeX capacity exceeded, sorry [mem_max=200000].
  127.  
  128. In order to typeset such documents other memory parameters may have to
  129. be increased also, including "mem_top", "hash_size", "hash_prime" and
  130. "hyph_size".  These latter changes mean that the format files have to
  131. be rebuilt.
  132.  
  133. For example, in order to typeset the XY-pic guide, reference manual,
  134. and technical documentation (330+ pages), using the XY-pic fonts, an
  135. OzTeX with a finder memory partition of 6.4 MBytes -- it has the
  136. parameter `mem_max=600000' -- was used.
  137.  
  138. Please experiment with the memory parameters until you find settings
  139. comfortable for your requirements.  The author would be happy to
  140. include, with future releases of XY-pic, a listing of typical settings
  141. which users have found to meet their needs.
  142.  
  143. ----------------------------------------------------------------------
  144.   -3- IMPORTANT: OzTeX AND THE POSTSCRIPT BACKEND
  145. ----------------------------------------------------------------------
  146.  
  147. IMPORTANT: If the XY-ps PostScript back-end is to be used with OzTeX,
  148. then two files are used frequently, namely `:PS-files:empty.ps' and
  149. `global.ps'.  The latter must be resident in the current folder.
  150.  
  151. Make sure that `empty.ps' indeed has empty contents, for the XY-ps
  152. \specials depend upon this. Also, if global.ps has non-empty contents,
  153. then take a copy for safe-keeping for XY-pic will need to overwrite it
  154. at some point, as will now be explained.
  155.  
  156. For the XY-ps \specials to work correctly a dictionary of PostScript
  157. definitions must be included with every document before printing. 
  158. These definitions are typically required on every page, so OzTeX's 
  159. `global.ps' mechanism is used to achieve this.  Indeed XY-ps checks 
  160. that this file is available. If it does not find it, or finds that 
  161. it is empty, then the required dictionary is written afresh and
  162. named `global.ps', so that OzTeX will recognize its purpose.
  163.  
  164. If your `global.ps' already has contents that you wish to continue to
  165. use, then append these to the end of the file created by XY-ps. You
  166. can force a fresh copy of the dictionary by placing \dumpPSdict near
  167. the beginning of any document.
  168.  
  169. The dictionary is included in the ready package as `ps/xy212dict.ps'.
  170.  
  171. LIMITATIONS: Not all of the PostScript effects that can be requested
  172. from the `line', `rotate' and `color' extension options are actually
  173. implementable by OzTeX.  The limitation is due to the way in which
  174. OzTeX handles the \special commands, collecting them all at the
  175. beginning of the PostScript file that it creates, followed by the
  176. rules and characters from fonts.
  177.  
  178. This means that the \special to initiate a special effect is followed
  179. soon after by the one necessary to revert to normal; this happens
  180. before any font characters are typeset.  Correct sequencing is
  181. maintained so that diagrams constructed purely from XY-pic objects
  182. such as lines, circles, curves and arrow-tips can be rotated, scaled
  183. and coloured correctly.  However any text characters in the diagram
  184. will not be rotated, scaled or coloured.
  185.  
  186. This situation is unfortunate, but nothing further can be done from
  187. within XY-pic and XY-ps. The code is already in place to implement
  188. these effects, as can be seen by the purely XY-pic diagrams working
  189. correctly. It remains for a future version of OzTeX to have \specials
  190. and font characters sequenced according to their occurrence within the
  191. DVI-file.
  192.  
  193. ----------------------------------------------------------------------
  194.   -4- BUGS & COMMENTS
  195. ----------------------------------------------------------------------
  196.  
  197. Bugs and questions concerning the OzTeX implementation of XY-pic
  198. should be directed to
  199.  
  200.   Electronic mail (Internet):  ross@mpce.mq.edu.au
  201.  
  202.   Paper mail:    Ross Moore
  203.         Mathematics Department
  204.         Macquarie University
  205.         North Ryde, Sydney
  206.         AUSTRALIA  2109
  207.  
  208.   Fax:        +61 (2) 805-8114
  209.  
  210. Generic bugs should be reported to Kristoffer Rose as described in the
  211. generic INSTALL file.
  212.  
  213. ----------------------------------------------------------------------
  214.  
  215. This is the end of the `INSTALL.OzTeX' description; below is a section
  216. with the files discussed above.  We hope you'll enjoy XY-pic!
  217.  
  218. ----------------------------------------------------------------------
  219.   -5- SETUP FILES.
  220. ----------------------------------------------------------------------
  221.  
  222. Below is the contents of each of the files discussed in point 3 of
  223. section -1- above.  Lines with only -s (dashes) are used to delimit
  224. the files.
  225.  
  226. ----------------------------------------------------------------------
  227.     :Configs:Default+XYpic 
  228. ----------------------------------------------------------------------
  229. %    This is the default configuration file read by OzTeX 1.7.
  230. %    Before making changes to this file it might be a good idea to save a copy.
  231. %    In your new default file you can then remove all the comments so that
  232. %    OzTeX starts up a little faster.
  233. %
  234. %    Follow these rules when editing configuration files:
  235. %    --    Lines starting with "%" are ignored; all other lines are significant.
  236. %    --    Each significant line must contain at least one "=" character.
  237. %        Any characters before the first "=" are ignored, as are spaces/tabs
  238. %        immediately after it.  The rest of the line contains the information
  239. %        used by OzTeX, usually in the form of one or more strings.
  240. %    -- If only one string is required then any further information is ignored
  241. %        and can be used for comments.
  242. %    --    Use double quotes around a string that includes one or more spaces.
  243. %    -- To avoid long significant lines, use "|" to split such lines anywhere
  244. %        you like.  Upon reading a "|", OzTeX will ignore the rest of the current
  245. %        line and continue reading from the next line.  The best place to use "|"
  246. %        is where a space is allowed, that way you can safely indent the next line
  247. %        to make the file more readable.  See below for examples.
  248. %    -- Two special characters are recognized in non-default configuration files.
  249. %        If "?" is the first non-space/tab after "=" then the corresponding
  250. %        parameter is not changed and the rest of the line is ignored.
  251. %        "!" is similar to "?" but in addition all remaining parameters are
  252. %        left unchanged (the rest of the file is ignored).
  253. %        These characters make it easy to create special-purpose configuration
  254. %        files; for examples, see the other files in the Configs folder.
  255. %
  256. config files            =                                    |
  257.     "Big TeX" "Big TeX+XYpic" "Big XY-TeX" ""     |
  258.     LaTeX LaTeX2e ""                                         |
  259.     "A5 Portrait" "A4 Landscape" "US Letter" ""    |
  260.     "View at 144 dpi" "View CM using PS" ""         |
  261.     StyleWriter ImageWriter ""                            |
  262.     "Add CM/PS Fonts" "Add Lucida Fonts" "Add MathTime Fonts"
  263. format files            = LaTeX2e Plain
  264. help files                =                                                                        |
  265.     "Questions and Answers" "Handy Hints" Problems "TeX Users Group"            |
  266.     "Related Software" "" "Changes to OzTeX 1.3" "Changes to OzTeX 1.4"        |
  267.     "Changes to OzTeX 1.41" "Changes to OzTeX 1.42" "Changes to OzTeX 1.5"    |
  268.     "Changes to OzTeX 1.6" "" "Shareware Fee" Thanks
  269. printer resolution    = 300            (screen resolution..3000 dots per inch)
  270. viewing resolution    = 300            (ditto)
  271. units                        = in            (in/cm/mm/pc/pt/bp/px)
  272. paper width                = 210mm        (A4 width; use 8.5in for US Letter paper)
  273. paper height            = 296mm        (A4 height; use 11in for US Letter paper)
  274. horizontal offset        = 0mm            (shift pages right if +ve, left if -ve)
  275. vertical offset        = 0mm            (shift pages down if +ve, up if -ve)
  276. show statistics        = false
  277. reverse page order    = false        (use true if pages are stacked face up)
  278. conserve VM                = false        (ignored if non-PostScript printer)
  279. manual feed                = false        (ditto)
  280. reserved                    = ignored
  281. %
  282. %    Some notes about the above significant lines:
  283. %    --    Don't change their order.
  284. %    --    The config files will appear as items at the end of the Config menu
  285. %        and should correspond to text files stored in the Configs folder.
  286. %        These strings are ignored in non-default configuration files.
  287. %    --    The format files will appear as items at the end of the TeX menu
  288. %        and should correspond to the names of ".fmt" files in the FMT folder
  289. %        (named below).  The format file names must not contain any spaces.
  290. %    --    The help files will appear as items in the Help menu and should
  291. %        correspond to text files in the Help folder (named below).
  292. %    --    The printer resolution is used when printing a DVI file and the
  293. %        viewing resolution is used when viewing a DVI file.  You might need to
  294. %        install an appropriate set of PK files if you change either value.
  295. %        Note that the minimum value is determined by the resolution of your
  296. %        monitor (typically 72 dpi).
  297. %    --    The units parameter tells OzTeX how to display all dimensions when
  298. %        printing/viewing a DVI file.
  299. %    --    The paper width and height dimensions are used to detect page-off-paper
  300. %        errors when printing/viewing a DVI file.  If the width is greater than
  301. %        the height then OzTeX will print/view the page in landscape mode.
  302. %        Note that these dimensions are ignored when printing on a non-PostScript
  303. %        printer; OzTeX will use the paper size and orientation specified in the
  304. %        current "Page Setup" options.
  305. %    --    The two offset dimensions affect the positioning of all pages when
  306. %        printing a DVI file.  They should only be changed if your printer has
  307. %        problems positioning the TeX origin; see page 2 in nasty.dvi.
  308. %        These offsets are NOT used when viewing a DVI file.
  309. %    --    The next four flags are default printing parameters.  If you are using
  310. %        a PostScript printer then all these parameters can be altered after
  311. %        selecting the DVI file to be printed.
  312. %
  313. %    The following parameters define the names and locations of OzTeX's special
  314. %    folders and files:
  315. %    --    Don't change their order.
  316. %    -- Folders and files are specified by "path names".  A path name can be a
  317. %        simple file name, or it can be a sequence of names (separated by colons)
  318. %        that represent a valid location in the folder hierarchy.  If the path
  319. %        name ends with a colon then it specifies a folder, otherwise a file.
  320. %    --    OzTeX will generate a warning message if a given path name does not
  321. %        specify a known folder or file.  Note that in System 7, OzTeX supports
  322. %        aliased files but NOT aliased folders.
  323. %    --    Partial path names begin with a colon.  The first folder in such a
  324. %        path is assumed to be in the same location as the OzTeX application.
  325. %        This is the best way to specify folders and files because then you can
  326. %        move the entire OzTeX folder anywhere you like without having to change
  327. %        any path names.
  328. %    --    Full path names begin with the name of a disk (or volume); eg:
  329. %        Help folder = HD40:OzTeX:Help-files:.
  330. %    -- Path names must be enclosed in double quotes if they contain any
  331. %        spaces; eg: Help folder = ":My help:".
  332. %    -- Multiple paths are allowed for TeX input files, TFM files, PK files,
  333. %        PS files and VF files.  These parameters also allow "*" at the end of a
  334. %        path name to tell OzTeX to include all sub-folders of the given folder
  335. %        in the search path.  Note that OzTeX does NOT automatically include
  336. %        sub-folders within sub-folders.
  337. %    --    When printing a DVI file, the global PS file is searched for in the
  338. %        current folder and, if found, included after the DVI-to-PS prolog.
  339. %    --    The pool file is read only by INITEX.
  340. %    --    The dummy TFM file is used by OzTeX to continue printing/viewing a DVI
  341. %        file after detecting a missing font.
  342. %    --    The dummy screen font will be used to simulate characters when
  343. %        viewing a DVI file with a missing font.
  344. %
  345. Help folder                = :Help-files:
  346. FMT folder                = :TeX-formats:
  347. %
  348. %    We can't use ":TeX-inputs:*" because we don't want BOTH LaTeX and LaTeX2e
  349. %    input files to be visible at the same time.  The initial search path is for
  350. %    LaTeX2e.  The LaTeX config file changes the search path to suit LaTeX 2.09.
  351. %
  352. TeX input folder(s)    = :TeX-inputs:Plain: :TeX-inputs:LaTeX2e: |
  353.     :TeX-inputs:PSNFSS2e: :TeX-inputs:Graphics2e: :TeX-inputs:XY-pic:
  354. TFM folder(s)            = :TeX-fonts:*
  355. PK folder(s)            = :PK-files:
  356. PS folder(s)            = :PS-files: :PS-files:Encodings:
  357. Text-to-PS prolog        = :PS-files:TEXTtoPS.ps
  358. DVI-to-PS prolog        = :PS-files:DVItoPS.ps
  359. VF folder(s)            = :VF-files:
  360. global PS file            = global.ps
  361. "Save OzTeX" output    = Oz.text
  362. reserved                    = ignored
  363. pool file                = :TeX-formats:TeX.pool
  364. dummy TFM file            = :TeX-fonts:CM:cmr10.tfm
  365. dummy screen font        = Geneva
  366. %
  367. %    The following parameters define some colours used when viewing a DVI file.
  368. %    The allowed colours are black, red, green, blue, cyan, magenta, yellow
  369. %    and white (white can be used to make something invisible).
  370. %    On black and white monitors all non-white colours appear black.
  371. %
  372. paper edges            = blue
  373. \special markers    = green
  374. missing fonts        = red
  375. %
  376. %    The following TeX parameters determine how much memory will be allocated
  377. %    for various arrays.  Some notes about these TeX parameters:
  378. %    --    Don't change their order.
  379. %    --    The bracketed comments indicate the possible range of values.
  380. %    --    If you increase any value substantially then before using OzTeX you'll
  381. %        need to increase the application memory.
  382. %    --    mem_max is temporarily set to mem_top whenever you run INITEX.
  383. %    --    For details about each parameter, see "TeX: The Program" by Donald Knuth.
  384. %
  385. mem_max                = 60000        (mem_top..100000000)
  386. font_max                = 120            (1..256)
  387. font_mem_size        = 30000        (8..100000000)
  388. max_strings            = 5000        (1300..16382)
  389. string_vacancies    = 20000        (0..pool_size-23500)
  390. pool_size            = 55000        (string_vacancies+23500..100000000)
  391. buf_size                = 1000        (120..32760)
  392. stack_size            = 200            (1..1600)
  393. max_in_open            = 6            (1..20)
  394. param_size            = 60            (1..8190)
  395. nest_size            = 40            (1..1000)
  396. save_size            = 600            (1..4094)
  397. trie_size            = 8000        (1..32760)
  398. trie_op_size        = 500            (1..16382)
  399. %
  400. %    If you change any of the next four parameters then you'll need
  401. %    to run INITEX and rebuild all fmt files.
  402. %    Some people will probably want to increase the hash_size value,
  403. %    so here are some suitable hash_prime values:
  404. %    hash_size    =  3000  4000  5000  6000  10000  20000  31000
  405. %    hash_prime    =  2551  3407  4253  5101   8501  16993  26347
  406. %
  407. mem_top                = 50000        (mem_min+1100..mem_max)
  408. hash_size            = 4000        (325..31000)
  409. hash_prime            = 3407        (prime about 85% of hash_size)
  410. hyph_size            = 307            (prime from 1..16382)
  411. %
  412. %    These parameters should only be changed to carry out TeX's TRIP test.
  413. %
  414. mem_min                = 0            (0..mem_top-1100)
  415. error_line            = 72            (45..32760)
  416. half_error_line    = 42            (30..error_line-15)
  417. max_print_line        = 79            (60..32760)
  418. %
  419. %    The remaining lines tell OzTeX which TFM files describe PostScript fonts
  420. %    (or more accurately, non-PK fonts).  Most of the entries are "raw" TFMs
  421. %    for the corresponding virtual fonts; raw TFMs have names ending in "0".
  422. %    Remember to run "Fix VFs in DVI" before printing or viewing a DVI file
  423. %    that uses virtual fonts.
  424. %
  425. %    The ordering of lines between the first and last "==" doesn't matter.
  426. %    In a non-default config file the first significant line can start with "=+";
  427. %    this tells OzTeX to add the given fonts to the current list (rather than
  428. %    delete the current list and build a new one).
  429. %
  430. == TFM        Printer font                        Screen font                Encoding        Style
  431. %
  432. =    ptmr0        Times-Roman                            Times                        Mac.enc
  433. =    ptmri0    Times-Italic                        Times                        Mac.enc        i
  434. =    ptmb0        Times-Bold                            Times                        Mac.enc        b
  435. =    ptmbi0    Times-BoldItalic                    Times                        Mac.enc        bi
  436. %
  437. %    The next few fonts are constructed by slanting the corresponding real fonts
  438. %    (the PSfont code in the DVI-to-PS prolog looks for the "Slanted-" prefix).
  439. %
  440. =    ptmro0    Slanted-Times-Roman                Times                        Mac.enc        i
  441. =    ptmbo0    Slanted-Times-Bold                Times                        Mac.enc        bi
  442. =    psyro        Slanted-Symbol                        Symbol                    nil            i
  443. %
  444. =    pagk0        AvantGarde-Book                    "Avant Garde"            Mac.enc
  445. =    pagko0    AvantGarde-BookOblique            "Avant Garde"            Mac.enc        i
  446. =    pagd0        AvantGarde-Demi                    "Avant Garde"            Mac.enc        b
  447. =    pagdo0    AvantGarde-DemiOblique            "Avant Garde"            Mac.enc        bi
  448. =    pbkl0        Bookman-Light                        Bookman                    Mac.enc
  449. =    pbkli0    Bookman-LightItalic                Bookman                    Mac.enc        i
  450. =    pbkd0        Bookman-Demi                        Bookman                    Mac.enc        b
  451. =    pbkdi0    Bookman-DemiItalic                Bookman                    Mac.enc        bi
  452. =    pcrr0        Courier                                Courier                    Mac.enc
  453. =    pcrro0    Courier-Oblique                    Courier                    Mac.enc        i
  454. =    pcrb0        Courier-Bold                        Courier                    Mac.enc        b
  455. =    pcrbo0    Courier-BoldOblique                Courier                    Mac.enc        bi
  456. =    phvr0        Helvetica                            Helvetica                Mac.enc
  457. =    phvro0    Helvetica-Oblique                    Helvetica                Mac.enc        i
  458. =    phvb0        Helvetica-Bold                        Helvetica                Mac.enc        b
  459. =    phvbo0    Helvetica-BoldOblique            Helvetica                Mac.enc        bi
  460. =    pncr0        NewCenturySchlbk-Roman            "New Century Schlbk"    Mac.enc
  461. =    pncri0    NewCenturySchlbk-Italic            "New Century Schlbk"    Mac.enc        i
  462. =    pncb0        NewCenturySchlbk-Bold            "New Century Schlbk"    Mac.enc        b
  463. =    pncbi0    NewCenturySchlbk-BoldItalic    "New Century Schlbk"    Mac.enc        bi
  464. =    pplr0        Palatino-Roman                        Palatino                    Mac.enc
  465. =    pplri0    Palatino-Italic                    Palatino                    Mac.enc        i
  466. =    pplb0        Palatino-Bold                        Palatino                    Mac.enc        b
  467. =    pplbi0    Palatino-BoldItalic                Palatino                    Mac.enc        bi
  468. =    pzcmi0    ZapfChancery-MediumItalic        "Zapf Chancery"        Mac.enc
  469. %
  470. %    The next two don't require virtual fonts:
  471. %
  472. =    pzdr        ZapfDingbats                        "Zapf Dingbats"        nil
  473. =    psyr        Symbol                                Symbol                    nil
  474. %
  475. %    The following lines show how to download non-resident fonts by adding
  476. %    an extra string (starting with "<") after the printer font name.
  477. %    Immediately after the "<" is the name of a file that should contain
  478. %    the required PostScript font information.  If the file is a standard Mac
  479. %    PostScript font file (of type LWFN) then OzTeX will download the relevant
  480. %    POST resources, otherwise it will assume the file is in PFA format and
  481. %    simply download all the text in the file's data fork.
  482. %
  483. %    OzTeX will only download a file if the corresponding font is actually used
  484. %    somewhere in the DVI file.  The specified file is searched for in the current
  485. %    folder first, and then in the PS folder(s).  The downloaded information is
  486. %    included in the PostScript output immediately after the DVI-to-PS prolog
  487. %    but before any global file.
  488. %
  489. =    putr0        Utopia-Regular        <putr.pfa    Utopia                    Mac.enc
  490. =    putri0    Utopia-Italic        <putri.pfa    Utopia                    Mac.enc        i
  491. =    putb0        Utopia-Bold            <putb.pfa    Utopia                    Mac.enc        b
  492. =    putbi0    Utopia-BoldItalic    <putbi.pfa    Utopia                    Mac.enc        bi
  493. ==
  494.  
  495. (OzTeX doesn't bother reading any stuff after the final "==", so we can
  496. add more documentation here without having to start each line with "%".)
  497.  
  498. If a DVI file uses PostScript fonts, the above TFM names get converted into
  499. printer font names when printing the DVI file on a PostScript printer,
  500. and into Macintosh screen font names when viewing the DVI file or printing
  501. it on a non-PostScript printer.
  502.  
  503. If you are unsure about which screen font would best match a particular
  504. PostScript font, you must still type something (such as "?").
  505. If OzTeX cannot find a specified screen font it will warn you and use
  506. use the system font instead (usually Chicago).
  507. To obtain the best results when viewing or printing a DVI file with
  508. PostScript fonts you should try to get the matching screen fonts.
  509.  
  510. An encoding entry is the name of a user-defined encoding file (or "nil"
  511. if the screen font uses the same encoding as its corresponding TFM file).
  512. When loading a config file, OzTeX looks for a given encoding file in the
  513. PS folder(s) and uses it to build an encoding array of 256 elements.
  514. This encoding array is then used when viewing a DVI file that uses the
  515. corresponding PostScript font, or when printing such a DVI file on a
  516. non-PostScript printer (it is NOT used during PostScript printing).
  517.  
  518. The Mac.enc encoding file maps characters from a standard PostScript text font
  519. to matching characters in a standard Macintosh text font.  Depending on the
  520. encoding scheme used in your PostScript TFMs or screen fonts, you might need
  521. to create other encoding files.  It isn't hard; see the comments at the start
  522. of Mac.enc.  For an interesting example of how encoding files can be used,
  523. see the "View CM using PS" config file.
  524.  
  525. Each screen font can appear in a certain style defined by a set of flags:
  526. b=bold, i=italic, u=underline, o=outline, s=shadow, c=condense, e=extend.
  527. An absence of flags tells OzTeX to use the font's plain style.
  528.  
  529. ----------------------------------------------------------------------
  530.     :Configs:Big TeX+XYpic
  531. ----------------------------------------------------------------------
  532. % This config file sets most TeX parameters to very large values.
  533. % OzTeX's preferred memory size will need to be at least 3100K.
  534. % If you don't have enough memory then reduce the values of mem_max
  535. % and mem_top.  Each unit reduction saves 8 bytes, so if mem_max and
  536. % mem_top are reduced by 100,000 then the required memory size drops
  537. % to about 2300K.
  538. %
  539. % If you decide to change other parameters then you'll need to adjust
  540. % OzTeX's memory size according to the total number of bytes saved or
  541. % added.  To determine this number:
  542. % - Use "Get Info" in the Finder's File menu to see OzTeX's current
  543. %   memory size (probably 1400K unless you changed it).
  544. % - Start OzTeX, run INITEX and hit Cmd-Dot when you get the "**" prompt.
  545. %   OzTeX shows the amount of memory allocated, so note down the number.
  546. % - Quit OzTeX and use "Get Info" to set OzTeX's memory size as high as
  547. %   you can.
  548. % - Start OzTeX again and select "Big TeX" (containing your changes)
  549. %   from the Config menu.
  550. % - Run INITEX and hit Cmd-Dot.  The amount of memory allocated
  551. %   should have changed; the difference should be rounded up to the
  552. %   nearest multiple of 10K or more (depending on how paranoid you are)
  553. %   and used to adjust OzTeX's ORIGINAL memory size.
  554. %
  555. % You'll need to run INITEX and build the big formats listed below
  556. % before you can use TeX with this configuration file.
  557. % The OzTeX User Guide describes how to build such format files.
  558. % If you want to change the given list of format files, make sure
  559. % the new names do not contain any spaces.
  560. %
  561. config files            = ignored
  562. format files            = Big-LaTeX2e Big-Plain
  563. help files                = ?
  564. printer resolution    = ?
  565. viewing resolution   = ?
  566. units                        = ?
  567. paper width                = ?
  568. paper height            = ?
  569. horizontal offset        = ?
  570. vertical offset        = ?
  571. show statistics        = ?
  572. reverse page order    = ?
  573. conserve VM                = ?
  574. manual feed                = ?
  575. reserved                    = ?
  576. Help folder                = ?
  577. FMT folder                = ?
  578. TeX input folder(s)    = ?
  579. TFM folder(s)            = ?
  580. PK folder(s)            = ?
  581. PS folder(s)            = ?
  582. Text-to-PS prologue    = ?
  583. DVI-to-PS prologue    = ?
  584. VF folder(s)            = ?
  585. global PS file            = ?
  586. Save OzTeX output        = ?
  587. reserved                    = ?
  588. pool file                = ?
  589. dummy TFM file            = ?
  590. dummy screen font        = ?
  591. paper edges                = ?
  592. \special markers        = ?
  593. missing fonts            = ?
  594. %
  595. % TeX parameters:
  596. %
  597. mem_max                = 200000        (mem_top..100000000)
  598. font_max                = 256            (1..256)
  599. font_mem_size        = 60000        (8..100000000)
  600. max_strings            = 10000        (1300..16382)
  601. string_vacancies    = 30000        (0..pool_size-23500)
  602. pool_size            = 160000        (string_vacancies+23500..100000000)
  603. buf_size                = 3000        (120..32760)
  604. stack_size            = 600            (1..1600)
  605. max_in_open            = 20            (1..20)
  606. param_size            = 200            (1..8190)
  607. nest_size            = 150            (1..1000)
  608. save_size            = 2000        (1..4094)
  609. trie_size            = 16000        (1..32760)
  610. trie_op_size        = 1000        (1..16382)
  611. mem_top                = 200000        (mem_min+1100..mem_max)
  612. hash_size            = 10000        (325..31000)
  613. hash_prime            = 8501        (prime about 85% of hash_size)
  614. hyph_size            = 2551        (prime from 1..16382)
  615. mem_min                = 0            (0..mem_top-1100)
  616. error_line            = 72            (45..32760)
  617. half_error_line    = 42            (30..error_line-15)
  618. max_print_line        = 79            (60..32760)
  619. %
  620. % Keep the current set of PostScript fonts:
  621. %
  622. =!
  623.  
  624. ----------------------------------------------------------------------
  625.     :Configs:Big XY-TeX
  626. ----------------------------------------------------------------------
  627. % Sets most TeX parameters to very large values.
  628. % The OzTeX application memory size will need to be about 3100K.
  629. % (If you don't have enough memory then reduce the values of mem_max
  630. % and mem_top.  Each unit reduction saves 8 bytes, so if mem_max and
  631. % mem_top are reduced by 100000 then the application memory required
  632. % drops to about 2300K.)
  633. %
  634. % You'll need to run INITEX and build the format files listed below
  635. % (with ".fmt" appended) before using TeX with this configuration file.
  636. % Note that format file names must not contain any spaces.
  637. %
  638. config files            = ignored
  639. format files            = Big-XY-Plain Bigger-LaTeX2e Big-XY-LaTeX2e
  640. help files                = ?
  641. printer resolution    = ?
  642. viewing resolution   = ?
  643. units                        = ?
  644. paper width                = ?
  645. paper height            = ?
  646. horizontal offset        = ?
  647. vertical offset        = ?
  648. show statistics        = ?
  649. reverse page order    = ?
  650. conserve VM                = ?
  651. manual feed                = ?
  652. reserved                    = ?
  653. Help folder                = ?
  654. FMT folder                = ?
  655. TeX input folder(s)    = ?
  656. TFM folder(s)            = ?
  657. PK folder(s)            = ?
  658. PS folder(s)            = ?
  659. Text-to-PS prologue    = ?
  660. DVI-to-PS prologue    = ?
  661. VF folder(s)            = ?
  662. global PS file            = ?
  663. Save OzTeX output        = ?
  664. reserved                    = ?
  665. pool file                = ?
  666. dummy TFM file            = ?
  667. dummy screen font        = ?
  668. paper edges                = ?
  669. \special markers        = ?
  670. missing fonts            = ?
  671. %
  672. % TeX parameters:
  673. %
  674. mem_max                = 600000        (mem_top..100000000)
  675. font_max                = 255            (1..255)
  676. font_mem_size        = 60000        (8..100000000)
  677. max_strings            = 10000        (1300..16382)
  678. string_vacancies    = 30000        (0..pool_size-23500)
  679. pool_size            = 160000        (string_vacancies+23500..100000000)
  680. buf_size                = 3000        (120..32760)
  681. stack_size            = 1600            (1..1600)
  682. max_in_open            = 20            (1..20)
  683. param_size            = 200            (1..8190)
  684. nest_size            = 150            (1..1000)
  685. save_size            = 2000        (1..4094)
  686. trie_size            = 16000        (1..32760)
  687. trie_op_size        = 1000        (1..16382)
  688. mem_top                = 600000        (mem_min+1100..mem_max)
  689. hash_size            = 10000        (325..31000)
  690. hash_prime            = 8501        (prime about 85% of hash_size)
  691. hyph_size            = 2551        (prime from 1..16382)
  692. mem_min                = 0            (0..mem_top-1100)
  693. error_line            = 72            (45..32760)
  694. half_error_line    = 42            (30..error_line-15)
  695. max_print_line        = 79            (60..32760)
  696. %
  697. % Keep current PostScript fonts:
  698. %
  699. =!
  700.  
  701. ----------------------------------------------------------------------
  702.